home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1995 May / cd Ware (Juegos) Epimundo.iso / DOS / C / C_ALGORI.ZIP / FIO.MAN < prev    next >
Encoding:
Text File  |  1992-05-12  |  2.7 KB  |  100 lines
  1. NAME
  2.         FioCheckFileClear - Check if a file exists
  3.  
  4. SYNOPSIS
  5.  
  6.         #include <fio.h>
  7.  
  8.         int  FioCheckFileClear(pcSeedPathName)
  9.         char * pcSeedPathName;
  10.  
  11. DESCRIPTION
  12.  
  13.         The file named as pcSeedPathName is checked for existance.
  14.  
  15. DIAGNOSTICS
  16.  
  17.         FIO_OK  - file does not exist
  18.         FIO_FILE_OLD    - file exists
  19.  
  20.  
  21. NAME
  22.         FioGetFile - determine if a file is ready for reading
  23.  
  24. SYNOPSIS
  25.  
  26.         #include <fio.h>
  27.  
  28.         int FioGetFile(pcSeedPathName,iWaitSecs)
  29.         char * pcSeedPathName;
  30.         int iWaitSecs;
  31.  
  32. DESCRIPTION
  33.  
  34.         The file named as pcSeedPathName is checked for its existance and
  35.         ability to be read based on a non-zero file size.  If the file does
  36.         not exist, the routine will wait up to iWaitSecs seconds for the
  37.         file to be created.
  38.  
  39.         NOTE:  With this release, FioGetFile no longer waits for a file
  40.                to grow beyond zero bytes in size.  Through testing it
  41.                was found that a process initiating communication to another
  42.                process should create the file using a temporary and private
  43.                filename.  After the file is closed, the file should be
  44.                renamed to the name expected by the target/receiver process.
  45.                This produces redundancy between FioGetFile and FioCheckFileClear.
  46.                FioCheckFileClear is provided for backwards compatibility.  
  47.                FioGetFile should be used instead of FioCheckFileClear in all 
  48.                new code.
  49.                
  50. DIAGNOSTICS
  51.  
  52.         FIO_OK  - file is ready for reading
  53.         FIO_NO_FILE - file does not exist
  54.  
  55.  
  56. NAME
  57.         FioRemoveFile - remove a file 
  58.  
  59. SYNOPSIS
  60.  
  61.         #include <fio.h>
  62.  
  63.         int  FioRemoveFile(pcSeedPathName)
  64.         char * pcSeedPathName;
  65.  
  66. DESCRIPTION
  67.  
  68.         File pcSeedPathName is removed.
  69.       
  70. DIAGNOSTICS
  71.  
  72.         The default value supplied by the operating system call is
  73.         passed back to the application.
  74.  
  75. NAME
  76.         FioIncSeedPathName - increment a seed path name
  77.  
  78. SYNOPSIS
  79.  
  80.         #include <fio.h>
  81.  
  82.         int  FioIncSeedPathName(pcSeedPathName)
  83.         char * pcSeedPathName;
  84.  
  85. DESCRIPTION
  86.  
  87.         File named by pcSeedPathName is given the next incrementing
  88.         filename in the sequence.  By default, the sequence for
  89.         file naming starts with the extension .000 (as supplied
  90.         by the application).  With each successive call to 
  91.         FioIncSeedPathName, the extension is incremented by 1.  When
  92.         the extension passed in is .999, the extension passed out
  93.         will wrap around to .000.
  94.  
  95. DIAGNOSTICS
  96.  
  97.         C_OK      - always returned
  98.  
  99.  
  100.